Obtaining Graphics Exporter Settings17

These functions are used for obtaining graphics exporter settings and displaying a settings dialog box.

GraphicsExportRequestSettings

Displays a dialog for the user to configure graphics exporter settings, if applicable.



 
pascal ComponentResult GraphicsExportRequestSettings (

                                         GraphicsExportComponent ci,

                                         ModalFilterYDUPP filterProc,

                                         void *yourDataProc);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
filterProc: A modal dialog filter proc. If you do not need one, pass nil .
yourDataProc: An extra parameter that will be passed to the filterProc when it is called. If you do not need one, pass nil .

DISCUSSION

Some graphics exporters don't support settings dialogs, and so do not implement this call. To find out whether a graphics exporter implements this call, useCallComponentCanDo ( myGraphicsExporter , kGraphicsExportRequestSettingsSelect ).

GraphicsExportSetSettingsFromAtomContainer

Sets the graphics exporter component's current configuration to match the settings in the passed atom container.



 
pascal ComponentResult GraphicsExportSetSettingsFromAtomContainer (

                     GraphicsExportComponent ci,

                     void *qtAtomContainer);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
qtAtomContainer: A QuickTime atom container containing settings.

DISCUSSION

The settings atom container may contain atoms other than those expected by the graphics exporter component or may be missing certain atoms. This function will only use settings it understands.

GraphicsExportGetSettingsAsAtomContainer

Retrieves the current settings from the graphics exporter component



 
pascal ComponentResult GraphicsExportGetSettingsAsAtomContainer (

                     GraphicsExportComponent ci,

                     void *qtAtomContainerPtr);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
qtAtomContainerPtr: Points to a variable to receive a new QuickTime atom container containing settings.

DISCUSSION

The caller is responsible for disposing of the returned atom container.

GraphicsExportGetSettingsAsText

Retrieves the current settings in a user-readable format.



 
pascal ComponentResult GraphicsExportGetSettingsAsText (

                                         GraphicsExportComponent ci,

                                         Handle *theText);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
theText: Points to a variable to receive a newly-allocated handle containing text.

DISCUSSION

The caller is responsible for disposing of the returned handle.